RubberbandSelection Property, SftTreeItems Object


	SftTreeItems.RubberbandSelection Property	Softel vdm, Inc.

Defines whether rubberband selection is enabled (multiple selection only).

Syntax

Get
	VB.NET	Boolean = object.RubberbandSelection As Boolean
	VB	Boolean = object.RubberbandSelection As Boolean
	C#.NET	bool Boolean = object.RubberbandSelection;
	VC++	VARIANT_BOOL Boolean = object->RubberbandSelection; VARIANT_BOOL Boolean = object->GetRubberbandSelection();
	C	HRESULT object->get_RubberbandSelection(VARIANT_BOOL* Boolean);
	Delphi	Boolean := object.RubberbandSelection : WordBool;
Put
	VB.NET	object.RubberbandSelection = Boolean As Boolean
	VB	object.RubberbandSelection = Boolean As Boolean
	C#.NET	bool object.RubberbandSelection = Boolean;
	VC++	VARIANT_BOOL object->RubberbandSelection = Boolean; void object->PutRubberbandSelection(VARIANT_BOOL Boolean);
	C	HRESULT object->put_RubberbandSelection(VARIANT_BOOL Boolean);
	Delphi	object.RubberbandSelection := Boolean : WordBool;

object

A SftTreeItems object.

Boolean

Defines whether rubberband selection is enabled (multiple selection only).

Boolean	Description
True	Enables click-drag selection of multiple items using a selection rectangle.
False	Click-drag selection of multiple items using a selection rectangle is not available.

Comments

The RubberbandSelection property defines whether rubberband selection is enabled (multiple selection only).

In a single selection tree control this property has no effect. Click-drag selection is only available in a multiple selection tree control and only if Items.SelectStyle is set to selectSftTreeCell1, selectSftTreeCellCurrent or selectSftTreeCell1Full. If Items.SelectStyle is set to selectSftTreeCellCurrent, click-dragging cannot start in the first column, it must be initiated from another column.

Click-drag selection with a "rubberband" selection rectangle can be initiated by pressing the mouse button on the cell background (not the cell text) of a cell and dragging the mouse cursor. All items between the starting and ending point are selected. If the mouse cursor approaches the edge of the tree control, scrolling will start, allowing selection of additional items. Once the mouse button is released, the currently selected items remain selected.